home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 6 / The Arsenal Files 6 (Arsenal Computer).ISO / telecom / inetm11.zip / INET_MAC.DOC < prev    next >
Text File  |  1996-02-19  |  38KB  |  887 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                             INTERNET IN A MACRo
  10.  
  11.                                 VERSION 1.1
  12.  
  13. BY J.J. MEDDAUGH AND JEFF BISHOP
  14.  
  15. COPYRIGHT 1996
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                              TABLE OF CONTENTS
  24.  
  25. INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  26.  
  27. Obtainging the Source . . . . . . . . . . . . . . . . . . . . . . . . .   1
  28.  
  29. Warranty  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  30.  
  31. FILES IN THIS ARCHIVE . . . . . . . . . . . . . . . . . . . . . . . . .   2
  32.  
  33. Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   2
  34.  
  35.                              STARTING INET_mac  . . . . . . . . . . . .   2
  36.  
  37. About Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  38.  
  39. Menu Shortcuts  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  40.  
  41. The Online Help System  . . . . . . . . . . . . . . . . . . . . . . . .   3
  42.  
  43. Jump to Item  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  44.  
  45. THE LOG FILe  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  46.  
  47. Error Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  48.  
  49. The Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4
  50.  
  51.                                The Site Menu  . . . . . . . . . . . . .   4
  52.                            THE MANUAL ENTRY MENU  . . . . . . . . . . .   4
  53.                             THE EDIT SITES MENU . . . . . . . . . . . .   4
  54.      Searching for a Site . . . . . . . . . . . . . . . . . . . . . . .   5
  55.      Site Statistics  . . . . . . . . . . . . . . . . . . . . . . . . .   5
  56.      Using External Macros  . . . . . . . . . . . . . . . . . . . . . .   5
  57.  
  58. THE UNIX FILE COMMANDS MENu . . . . . . . . . . . . . . . . . . . . . .   6
  59.                                  LIST FILES . . . . . . . . . . . . . .   6
  60.                                DELETE A FILE  . . . . . . . . . . . . .   6
  61.                               DOWNLOAD A FILE . . . . . . . . . . . . .   6
  62.                                UPLOAD A FILE  . . . . . . . . . . . . .   6
  63.  
  64. Mail Functions  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  65.      Sending Mail . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  66.      Mail Yourself  . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  67.      Address Book . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  68.      Distributing a Message . . . . . . . . . . . . . . . . . . . . . .   8
  69.      Fingering a User . . . . . . . . . . . . . . . . . . . . . . . . .   8
  70.      Sending a Bug Report . . . . . . . . . . . . . . . . . . . . . . .   8
  71.  
  72.                                 The IRC Menu  . . . . . . . . . . . . .   8
  73.      Efnet  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  74.      Undernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  75.      Other IRC NETWORKS . . . . . . . . . . . . . . . . . . . . . . . .   9
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83. The Configuration Menu  . . . . . . . . . . . . . . . . . . . . . . . .   9
  84.      General Config . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  85.           System Prompt . . . . . . . . . . . . . . . . . . . . . . . .   9
  86.           Email Address . . . . . . . . . . . . . . . . . . . . . . . .   9
  87.           FTP Command-line  . . . . . . . . . . . . . . . . . . . . . .  10
  88.      File Config  . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  89.           Signature File  . . . . . . . . . . . . . . . . . . . . . . .  10
  90.           Site List File  . . . . . . . . . . . . . . . . . . . . . . .  10
  91.           Message File  . . . . . . . . . . . . . . . . . . . . . . . .  10
  92.           Email Alias File  . . . . . . . . . . . . . . . . . . . . . .  10
  93.           Log File  . . . . . . . . . . . . . . . . . . . . . . . . . .  10
  94.           Distribution List . . . . . . . . . . . . . . . . . . . . . .  10
  95.           Tagline File  . . . . . . . . . . . . . . . . . . . . . . . .  11
  96.           Inet_mac Directory  . . . . . . . . . . . . . . . . . . . . .  11
  97.      External Macro Config  . . . . . . . . . . . . . . . . . . . . . .  11
  98.           External Macro for FTP  . . . . . . . . . . . . . . . . . . .  11
  99.           External Macro for Gopher . . . . . . . . . . . . . . . . . .  11
  100.           External Macro for Rlogin . . . . . . . . . . . . . . . . . .  11
  101.           External Macro for Telnet . . . . . . . . . . . . . . . . . .  11
  102.           External Macro for WWW  . . . . . . . . . . . . . . . . . . .  11
  103.  
  104. Appendix A: Using Variables in Support Files  . . . . . . . . . . . . .  12
  105.  
  106. Appendix B: Menu Shortcuts  . . . . . . . . . . . . . . . . . . . . . .  13
  107.  
  108. OBTAINING NEW VERSIONS OF INET_mac  . . . . . . . . . . . . . . . . . .  14
  109.  
  110. Thanks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  111.  
  112.                                   Support . . . . . . . . . . . . . . .  14
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                 INTRODUCTION
  121.  
  122.   Internet in  a Macro was designed to make the Internet more enjoyable and
  123. easier  to use.   It includes  a myriad  of features  that allow you  to do
  124. virtually anything on the information superhighway.  The following features
  125. are included:
  126.  
  127. * Supports Ftp, Gopher, Rlogin, Telnet, and WWW
  128. * Unlimited menu-Driven Site Database with submenus and search capability
  129. * Built-in menu editing capabilities
  130. * Automatically connect to IRC using nickname and go directly to channel
  131. *  Emailing  of prewritten  letters with  built-in  address book  and alias
  132. support
  133. * Online email address book manager
  134. * Appending of random tagline to message
  135. * Unlimited bulk mail capability
  136. * Finger capability using address book
  137. * Online help using Cmhelp
  138. * All configuration items can be changed from menus
  139. * Keeps log file of what you did
  140. * Built-in vt102 keyboard assignments
  141.  
  142.                            Obtainging the Source
  143.  
  144.   Due to security reasons, the source code of this program is not available
  145. publicly.  However,  some of the subroutines used in  this and other macros
  146. that  I've written are  in the file  Macro Subroutines  Volume 1.   You may
  147. obtain  this file from  various places.   See  the end  of this  manual for
  148. information on where to get Commo macros.
  149.  
  150.                                  Warranty 
  151.  
  152.   The  author OF THIS PROGRAM, Jason J. Meddaugh, DISCLAIMS ALL WARRANTIES,
  153. EITHER EXPRESS OR  IMPLIED,  INCLUDING,  BUT   NOT   LIMITED   TO,  IMPLIED
  154. WARRANTIES   OF MERCHANTABILITY AND FITNESS FOR A  PARTICULAR PURPOSE, WITH
  155. REGARD  TO THE  SOFTWARE and  THE ACCOMPANYING  WRITTEN MATERIALS.   IN  NO
  156. EVENT  SHALL   THE  AUTHOR   BE LIABLE   TO  YOU   FOR ANY   CONSEQUENTIAL,
  157. SPECIAL, INCIDENTAL  OR INDIRECT DAMAGES  OF  ANY  KIND ARISING OUT  OF THE
  158. USE OF  THE  SOFTWARE, EVEN IF THE AUTHOR  HAS BEEN SPECIFICALLY ADVISED OF
  159. THE POSSIBILITY OF SUCH   DAMAGES.  IN NO EVENT WILL THE AUTHOR'S LIABILITY
  160. EXCEED THE ACTUAL PRICE PAID FOR THE LICENSE TO  USE THE SOFTWARE. YOUR USE
  161. OF THIS PROGRAM CONSTITUTES YOUR ACCEPTANCE OF THESE TERMS. 
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 2
  170.  
  171.  
  172.                            FILES IN THIS ARCHIVE
  173.  
  174.   These files should of been included  in the Inet_mac archive.  If one  or
  175. more of these files is missing or tampered with, please get a new copy.  If
  176. you downloaded a faulty or hacked copy from somewhere, please let me know.
  177.  
  178. Filename.ext  Description
  179. ---------------------------------------------------------------------------
  180. inetinst.bat  Batch file to start installation macro
  181. inetinst.ccm  Installation macro
  182. inet_mac.ala  Email alias file
  183. inet_mac.ccm  The macro itself
  184. inet_mac.dis  Sample distribution list file
  185. inet_mac.his  History file
  186. inet_mac.hlp  Online help file
  187. inet_mac.idx  Help index for Cmhelp
  188. inet_mac.sig  Signature file
  189. inet_mac.sit  Internet site list
  190. inet_mac.tag  Tagline file
  191. inet_mac.txt  This file
  192. inet_sit.mac  Sample macros for sites
  193.  
  194.                                 Installation
  195.  
  196.   The  easiest way to  install Internet in  a Macro is to  run the included
  197. installation program.   Make sure  that that the  program files are  in the
  198. Commo directory and then type
  199.  
  200. inetinst
  201.  
  202. You will be  asked whether  or not you  want to install  Inet_mac.  If  you
  203. choose  to do so,  you are asked for  a keylabel to  use.  The installation
  204. program  will add a line to  Commo.mac that will let  you start the program
  205. from the terminal  screen.  The default key is Alt-F2 and if you hit return
  206. at this prompt, this will be used.  Refer to commo.doc for a list  of other
  207. key labels.  If you pick one that is already used, you are asked to confirm
  208. that you really  want to  use this  label.  If  you get  this message,  you
  209. should probably select no and pick  another label.  Once you have  picked a
  210. key label, the program will add a line to commo.mac and the installation is
  211. complete.
  212.   Advanced users might prefer to edit their commo.mac file manually.  To do
  213. this, add a line similar to this in your commo.mac file
  214.  
  215. {:af2} {goto start,inet_mac.ccm}
  216.  
  217. This will cause Alt-F2 to become a  hotkey for starting Inet_mac.  You  can
  218. use any key you wish for starting the program by changing the key  label in
  219. the macro.  See commo.doc for a listing of valid key labels.
  220.  
  221.                              STARTING INET_mac
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 3
  230.  
  231.   To  start  Inet_mac from  the terminal  screen,  press the  key  that you
  232. selected as a hotkey in the installation and you're off and running.
  233.  
  234.                                 About Menus
  235.  
  236.   Internet in a Macro runs almost  exclusively through menus.  When you are
  237. at a menu, you may hit  escape to go back to  the previous menu or exit  if
  238. you are at the main menu.  Also,  F1 will give you online help at any menu.
  239. Select a  menu item  by pressing  its corresponding letter.   Do  not press
  240. return after selecting an option from a menu.
  241.  
  242.                                Menu Shortcuts
  243.  
  244.   Notice that when you are at the  main menu, a shortcut key is shown  next
  245. to each option.  If the macro is loaded into memory, you may go directly to
  246. a submenu from  the terminal  screen by simply  pressing its  corresponding
  247. shortcut key.  See appendix B for a list of Inet_mac shortcut keys.
  248.  
  249.                            The Online Help System
  250.  
  251.   You may get online  help from any menu by  pressing F1.  When you  are in
  252. the help window, press return or space to  advance a pag and B to go back a
  253. page.  You can press  T and the topic code to go to  another help topic.  H
  254. gives you the command summary  for the help system.  The number  0 jumps to
  255. the beginning  of the  file.   Escape exits  help.   The  help system  uses
  256. Cmhelp, which is another macro that  I have written.  See my list  of other
  257. Commo macros at the end of this manual.
  258.  
  259.                                 Jump to Item
  260.  
  261.   From any menu, you  may hit Z to jump  to any other part of  the program.
  262. You  may jump  to the  site menu,  the address  book, or  any configuration
  263. option,  for example.   You are prompted for  the name of  the place to go.
  264. Hit return  here for a  list of menus  and options and  the keywords  to go
  265. there, or  type in a  keyword and  hit return.   Hit escape  to cancel  and
  266. return to the current menu.
  267.  
  268.                                 THE LOG FILe
  269.  
  270.   Inet_mac  will,  if instructed  to  do  so,  keep  a  log  file  of  your
  271. activities.  The name  of the log file can be  changed in the configuration
  272. menu, discussed later  in this manual.   Each line  in the file looks  like
  273. this:
  274.  
  275. Date, Time: Event
  276.  
  277. Events  that are  logged  include  a  successful  connection  or  an  error
  278. connecting to a site, an IRC connection, or a sent mail message.
  279.  
  280.                                 Error Boxes
  281.  
  282.   Several options in Inet_mac will  bring up error boxes if the  action was
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 4
  291.  
  292. unsuccessful.  These  include an  unsuccessful connection to  a site.   You
  293. will be given a detailed description of the error.  To  close an error box,
  294. press return, escape, or C.
  295.  
  296.                                The Main Menu
  297.  
  298.   The main  menu allows you  to access  the various parts  of the  program.
  299. These parts ard discussed in detail in the following sections.
  300.  
  301.                                The Site Menu
  302.  
  303.   The site menu  is where you can access the  Internet through FTP, Gopher,
  304. Rlogin, Telnet,  and  the World  Wide Web.    The main  site  menu and  any
  305. submenus you may have will all appear the same  on the screen.  The data is
  306. read from the site  file.  When you first enter the  site menu, the program
  307. will search for a label in the site file called [main].  The first 18 sites
  308. from the current menu are read and presented on the screen.  Any additional
  309. sites are ignored.   The bottom part of  the screen shows the  choices that
  310. are valid at all menus.
  311.   Sites are  lettered A through V  on the screen (some  letters are skipped
  312. because they  are used  for other  options explained below).   To  select a
  313. site, press the corresponding letter.  Inet_mac will then try to connect to
  314. the site selected.   If you  selected a menu, it  will be displayed  in the
  315. same  manner.  Escape will cancel connecting to a site or return you to the
  316. previous site menu or the main menu.
  317.   If no sites are found in the file for a menu, a message will appear where
  318. the  menu normally  would advising  you  that there  are no  sites for  the
  319. current menu and tell you how to add some.
  320.   If you select  the M option from  any site menu, you  will be put in  the
  321. manual entry  menu.  Alternatively,  E will allow  you to edit  the various
  322. site  menus or  return you  to the  previous site  menu if  you  are in   a
  323. submenu.  If you want to connect to a site but don't remember which menu it
  324. is on, select S to search for it.
  325.  
  326.                            THE MANUAL ENTRY MENU
  327.  
  328.   This menu  allows you to go to an Internet  site by manually entering its
  329. address.   Select  the type  of site  from the  menu, FTP,  Gopher, Rlogin,
  330. Telnet, or WWW.   The macro will ask you  for the site's address.   Type in
  331. the address you wish  to go to and hit  return.  It will atempt  to connect
  332. you to the site.   NOte that for WWW sites, you do  not have to include the
  333. http:// part of  the address.   If you don't,  it will be automatically  be
  334. added.
  335.  
  336.                             THE EDIT SITES MENU
  337.  
  338.   This is  where you can  edit Inet_mac's site  menus.  D displays  the raw
  339. contents of the  site file using the built-in file viewer.   E will let you
  340. edit the raw site list file.  This is only recommended for advanced users.
  341.   A for add and R  for remove will, as implied, let you add  or remove menu
  342. choices.  When  adding a choice,  you will be asked  for the menu  that you
  343. want  to add the  choice to.   The current menu  is the default  and can be
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 5
  352.  
  353. selected by pressing return.    You can also enter another  menu.  Then you
  354. will be asked for the  site type.  Enter the letter for the  type you want.
  355. You will then  be asked for the  site's address and  the site name.   Enter
  356. these and hit return.   The choice will be added.  If you selected menu for
  357. the site type,  you will be asked  for the menu label.   Make it short  and
  358. easy to remember.   Then you are asked for the  menu name which is shown on
  359. the sites menu.  This is the descriptive name for the menu.
  360.   When removing  a site, you  are simply  asked for its  name.  It  will be
  361. searched for, and then you will be asked if you are sure you want to remove
  362. it.  Press  Y or N.  If you  choose yes, the site will be  removed.  Either
  363. way, you will be returned to the edit sites menu.
  364.   The S and I options  work similarly.  Pressing  S will let you import  an
  365. address for a site  that is on the screen and I will  let you search a file
  366. for addresses.  If  you hit I, you are asked for the  name of the file that
  367. you want to search.  Presuming it  exists, you are then shown possible site
  368. addresses that are  found in the  file.  The S  option does the  same thing
  369. skipping  the filename prompt.  Inet_mac will  try to determine the type of
  370. site but many times it is impossible.  It if can, it will tell you.  Either
  371. way, you are prompted whether or not to add the site.  If you decide to add
  372. it, you are  prompted for the  menu to add  the site, the  site type if  it
  373. couldn't be  determined, and the  name of the  site.  Either  way, Inet_mac
  374. will continue searching for  more sites until  the end of  the file or  the
  375. bottom of the screen was reached.  You are then returned  to the edit sites
  376. menu.
  377.  
  378.                             Searching for a Site
  379.  
  380.   The S option  on the  site menu will  let you  directly go to  a site  by
  381. entering a partial  address or name.   You are  prompted for the string  to
  382. search  for.  Enter enough  of the address  or name to  distinguish it from
  383. other sites and  press return.   You are then shown  sites that match  your
  384. search string and asked if  you want to connect to them.  Select  yes to go
  385. to the site and  exit the program or no to search for  more matches.  If no
  386. sites were found or no more matches  could be found, an error message  will
  387. appear.  
  388.  
  389.                               Site Statistics
  390.  
  391.   THe T option from the site  menu will cause the program to  generate some
  392. useful and  novelty statistics  about the  site file  and the  current menu
  393. including the name of the  menu and how many options are on it.   Press any
  394. key from this screen to return to the current site menu.
  395.  
  396.                            Using External Macros
  397.  
  398.   Internet in  a Macro allows the use of external macros when connecting to
  399. a site through the site menu.  You can define  a different macro label/file
  400. to  go to  for each  type of  site, FTP, Gopher,  Rlogin, Telnet,  and WWW.
  401. These can be set or changed in the external macro configuration menu.
  402.   When you connect to  a site with an external macro defined  for it, it is
  403. run.  If you provide Inet_mac with an invalid label or macro file, an error
  404. box will display.
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 6
  413.  
  414.   When the  macro  is run,  several  variables will  be  set for  your  use
  415. including  %addr, the  site's address.   This  variable allows  you to  use
  416. different macros for different sites.
  417.   This example will  change to the  Commo directory at  ordata.com if  that
  418. site is selected or terminate if another site was selected.
  419.  
  420. {:ftp}
  421. {comp addr,ordata.com} {ifco ordata}
  422.   Check to see if connecting to ordata.com, if true, go to the Ordata macro
  423. {return}
  424.   If not, end; note that you could check for other sites in the same way
  425. {:ordata}
  426.   The Ordata macro
  427. {look ftp>} {send cd/pub/msdos/comm/COMMO]
  428.   Look for the prompt and change to the Commo directory
  429. {return}
  430.   Return control back to Inet_mac and exit
  431.  
  432.   It is  important to use  {return} instead  of {stop} to  end an  external
  433. macro.
  434.  
  435.                         THE UNIX FILE COMMANDS MENu
  436.  
  437.   This menu allows  you to perform some of the  basic Unix file operations,
  438. i.e. your  files in your Unix directory on your  account.  You can list and
  439. delete files as well as  download and upload files  to and from your  local
  440. hard drive.
  441.  
  442.                                  LIST FILES
  443.  
  444.   the L option will list the files in the current directory.  All files are
  445. listed, and the program will exit after you select this choice.
  446.  
  447.                                DELETE A FILE
  448.  
  449.   This command  will let you permanently  remove a file or  group of files.
  450. You are  asked for  the name  of the  file you  wish to delete.   Use  with
  451. caution.
  452.  
  453.                               DOWNLOAD A FILE
  454.  
  455.   This command,  selected by pressing  S, will let  you download a  file or
  456. group of  files.   After  selecting  this option,  you  are asked  for  the
  457. filename  you wish  to  download.   A  Zmodem  download will  be  initiated
  458. automatically and you will be returned to the Unix file commands menu.   If
  459. the  filename you entered could  not be found, you  will be notified and be
  460. returned to the menu.  If an error occurs  during a file transfer, you will
  461. be notified and returned to the menu.
  462.  
  463.                                UPLOAD A FILE
  464.  
  465.   This command, selected by pushing  R on the Unix file menu,  performs the
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 7
  474.  
  475. exact  opposite action of the  download command.  It will  upload a file or
  476. group of files  from your hard  driv to your account.   You are  once again
  477. prompted for a  filename and will be  notified if it  does not exist.   You
  478. will then be returned to the Unix file  menu.  If an error occurs during  a
  479. file transfer, you will be informed and returned to the menu.
  480.  
  481.                                Mail Functions
  482.  
  483.   Inet_mac  offers  the user  a host  of  mail functions  including sending
  484. prewritten messages, an  address book, and a distribution  list.  These can
  485. be accessed from the mail menu or M from the main menu.
  486.  
  487.                                 Sending Mail
  488.  
  489.   The S  option from  the mail  menu will let  you send  a mail  message to
  490. someone on the  Internet.  You  are first prompted  for the address of  the
  491. person.   Enter  in any valid  email address  or an  email alias (discussed
  492. below).  If the  address is valid, you are  asked for a file to  include as
  493. your message.  If  you do not specify a  file, you are allowed to  edit the
  494. message manually using Commo's built-in editor or an external editor if you
  495. have  one defined in your commo.set  file.  Finally, you  are asked for the
  496. subject of your message.  You may  leave this field blank, though it is not
  497. recommended.
  498.   If you are sending a prewritten  letter, after you enter the subject, the
  499. letter will be sent.  If you have Confirm Tagline set to yes in the Toggles
  500. Config (see below), you are shown  a tagline and asked whether you  want to
  501. use  this tagline,  pick  another one,  or  not append  a  tagline at  all.
  502. Whether this  happens  or not,  you  are told  that  the message  was  sent
  503. successfully and,  after pressing  any key,  will be  returned to  the mail
  504. menu.
  505.   If  you choose to  edit your message  manually, you are  presented with a
  506. dialogue box that shows the address and subject of the letter that you  are
  507. about to  edit.  Press enter or Y if you wish to continue or escape or N to
  508. cancel  the operation  and return  to the  mail menu.   After  editing your
  509. message, you are  asked to confirm the sending of your message.  Then it is
  510. sent in the same manner as a prewritten message.
  511.  
  512.                                Mail Yourself
  513.  
  514.   This command  will let you mail  a letter to yourself,  using the address
  515. that  you specified  in  the configuration  menu  discussed later  in  this
  516. manual.  THis is useful if you  want to test something or if you're  really
  517. lonely.
  518.  
  519.                                 Address Book
  520.  
  521.   The address book is where you edit your email alias list.  From here, you
  522. can display, add, and delete aliases.
  523.   The D  option will display the  raw alias file using  the built-in pager.
  524. The E  option will let you  manually edit the file,  not recommended unless
  525. you're an advanced Commo or Inet_mac user.
  526.   The A option will let you add new  aliases.  You are first asked for  the
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 8
  535.  
  536. alias to add.  Type it in and  press return.  Then enter the email  address
  537. and optionally a  name for reference.   It will  be added  and you will  be
  538. returned to the address book menu.
  539.   Removing  an address is quite  simple.  Just  type in the  alias that you
  540. wish to remove and you are asked for confirmation.  If you decide to delete
  541. the alias or not, you will be returned to the address book menu.
  542.   The I option will allow you to search a file for email addresses and then
  543. decide whether or not  you want to add them  to the address book.   This is
  544. nice if you have a large file with some addresses in it and you  don't feel
  545. like recopying  them manually.   You are  asked for a  filename and,  if it
  546. exists, Inet_mac will search the file for possible addresses.  The S option
  547. does a similar task,  but the screen is searched for addresses instead of a
  548. file.  If it finds one,  you are asked whether or  not you want to add  it.
  549. If you  say yes,  you are  prompted for the  alias and  the optional  name.
  550. Either way, you will eventually cause the program to continue searching for
  551. more addresses until the file has been searched.
  552.  
  553.                            Distributing a Message
  554.  
  555.   This  option, D  from  the mail  menu,  will let  you send  a  message to
  556. multiple addresses at the same time.   You are first prompted for the  name
  557. of the distribution list file.  THis file should contain the addresses that
  558. you want to distribute the  message to, one on each line.  If  you just hit
  559. return, you  can manually enter each  address.  You are  prompted for valid
  560. email addresses one per line.  This will continue until you hit return on a
  561. line by itself.
  562.   After  this, the procedure is  the same for sending a  message.  You will
  563. hear a short beep after each copy of  the message is sent and will be  told
  564. how  many  addresses the  message  was sent  to  at the  completion  of the
  565. distribution.
  566.  
  567.                               Fingering a User
  568.  
  569.   The F  option will let  you Finger a  user.  Fingering  will let  you see
  570. whether or  not a user  is online,  and depending on  the site,  some other
  571. information.  Enter the  address that you wish to finger  or an email alias
  572. and it will be fingered.  Inet_mac will exit after this operation.
  573.  
  574.                             Sending a Bug Report
  575.  
  576.   If  you have  a problem with  Inet_mac, this  option, B  from the message
  577. menu, will let you tell me about it.  The procedure is the same  as sending
  578. a  mail message,  except that  it will  automatically be  send to  my email
  579. address  and a copy of your configuration  settings will be appended to the
  580. message.  Be sure to use this option instead of the normal send mail option
  581. if you have a bug report to help solve the problem faster.
  582.  
  583.                                 The IRC Menu
  584.  
  585.   This menu, choice I from the main menu, allows you to connect  to various
  586. IRC  networks on the  Internet.  IRC  stands for  Internet Relay Chat.   It
  587. allows realtime chat between thousands of people at the same time.
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop             Page 9
  596.  
  597.                                    Efnet
  598.  
  599.   The Efnet is the biggest IRC network.  There is usually from 5,000-10,000
  600. people using it simultaneously.  Selecting E from the IRC menu will connect
  601. you to  this  network  using the  address  set in  the  configuration  menu
  602. discussed later in this manual.  If you don't know any addresses for  Efnet
  603. servers, and default addresses in the  configuration menu should work.  The
  604. message "Connecting to  IRC" will appear  on the  status line and  Inet_mac
  605. will attempt to connect.   Once connected, you will be put in  your default
  606. channel if  one is specified in the configuration menu.  Your nickname will
  607. also  be used as specified  in the IRC config menu.   If the connection was
  608. unsuccessful, you will be returned to the IRC menu.
  609.  
  610.                                   Undernet
  611.  
  612.   The  Undernet  is  the second  largest  IRC  network  with anywhere  from
  613. 1,500-5,000 users at one time.  The procedure to connect to the Undernet is
  614. identical to connecting to Efnet described above, except for that you go to
  615. Undernet  by  pressing U  from the  IRC menu  and  the Undernet  server, as
  616. defined in the IRC config menu, is used.
  617.  
  618.                              Other IRC NETWORKS
  619.  
  620.   The O  choice works the  same as the  two choices discussed  above except
  621. that you will be  connected to any other  predefined IRC network as set  in
  622. the  IRC config menu.   One  such network  is Dalnet,  and this  network is
  623. preconcfigured for you in the IRC configuration menu.
  624.  
  625.                            The Configuration Menu
  626.  
  627.   Inet_mac is quite configurable, and this menu, C from the main menu, will
  628. let you change the over 30 configuration settings in the program.
  629.   When  selecting  a configuration  setting to  change,  you are  shown the
  630. current setting  and allowed  to edit  or modify  with using Commo's  input
  631. editor.   You may leave  some options  blank.  However,  if you  attempt to
  632. leave an option  blank that is required,  you will not be allowed  to.  FOr
  633. toggles, selecting the option will turn the item either on or  off.  If the
  634. sound is turned  on, you will here  a tone that either  goes up or down  to
  635. confirm your selection.
  636.  
  637.                                General Config
  638.  
  639.   This menu, G  from the configuration menu,  will let you set a  few basic
  640. and necessary configuration settings.
  641.  
  642.                                System Prompt
  643.  
  644.   The system prompt is what is displayed to you in Unix when it  is waiting
  645. for a command.  This is option A from the general config menu.
  646.  
  647.                                Email Address
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop            Page 10
  656.  
  657.   Option B asks for your Internet electronic mail address, the address that
  658. other  people on  the Internet  can contact  you at.   This  should be  the
  659. address  for the account you use  Inet_mac with.  It should  be in the form
  660. user@host.
  661.  
  662.                               FTP Command-line
  663.  
  664.   Option  C provides compatibility for users who  do not have access to the
  665. NCFTP program for FTP.  If you do not have a problem using FTP,  leave this
  666. option as it is.  Otherwise, try changing it to just FTP.
  667.  
  668.                                 File Config
  669.  
  670.   This section, F from the main configuration menu, will let you change the
  671. default  filenames  for the  support files  and  choose the  directory that
  672. Inet_mac will look for these files in.
  673.  
  674.                                Signature File
  675.  
  676.   Choice A is for your signature file.  This  is a file, usually just a few
  677. lines, that will be appended to all outgoing mail messages as a signature.
  678.  
  679.                                Site List File
  680.  
  681.  
  682.   Option B will let you change the name of the site file.  This is the file
  683. that the program uses for the various site menus you define.
  684.  
  685.                                 Message File
  686.  
  687.   Option  C  will let  you tell  Inet_mac the  default name  of a  file for
  688. inclusion in mail  messages.  You  can change this  when sending a  message
  689. from the mail menu.  This option can be left blank for no default
  690.  
  691.                               Email Alias File
  692.  
  693.   Option  D is for  your email alias  file.  This  file contains your email
  694. aliases.  They can be used when sending a mail message or fingering a user.
  695.  
  696.                                   Log File
  697.  
  698.   This is  the name of the file  that Inet_mac will log  your activities on
  699. the net.   You may leave  this option blank if  you do not want  a log file
  700. created.  It is choice F from the file config menu.
  701.  
  702.                              Distribution List
  703.  
  704.   This  file is  the default  distribution list,  used when  distributing a
  705. message  to multiple recipients.   You may change  this from the distribute
  706. option on the  mail menu.  It  can be changed by  pressing F from the  file
  707. config menu.
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop            Page 11
  716.  
  717.                                 Tagline File
  718.  
  719.   Choice  G will let you change the name of the file that Inet_mac will use
  720. for taglines.  When sending a message, a random line of text will be picked
  721. from this file and used as a tagline.
  722.  
  723.                              Inet_mac Directory
  724.  
  725.   You may  optionally  tell  Inet_mac  to look  for  support  files  in  an
  726. alternate directoory other than the Commo home directory, the default.  You
  727. may enter  the directory  in  any way  that is  accepted  by DOS  including
  728. entering the  full path, the path  relative to the root  directory, and the
  729. path relative to the Commo home  directory.  It does not matter  whether or
  730. not  you append a backslash "\" to  the directory name, because the program
  731. will do  it for you if  you don't.   After entering the directory  name, it
  732. will change  what you entered to  the full path, including  drive, to avoid
  733. errors.  This is option H from the file config menu.
  734.  
  735.                            External Macro Config
  736.  
  737.   Option M from the configuration menu  will let you set up external macros
  738. to go to when Inet_mac successfully connects to a site.
  739.  
  740.                            External Macro for FTP
  741.  
  742.   This is  the external macro that  will be launched upon  a successful FTP
  743. connection.  It is option F from the external macro config menu.
  744.  
  745.                          External Macro for Gopher
  746.  
  747.   Option  G is for the external  macro to run when you  connect to a Gopher
  748. site.
  749.  
  750.                          External Macro for Rlogin
  751.  
  752.   Option R is  the external macro that  you want run when a  Rlogin site is
  753. connected to.
  754.  
  755.                          External Macro for Telnet
  756.  
  757.   This macro will  be run when a  site is connected to  via Telnet.  It  is
  758. option T from the external macro config menu.
  759.  
  760.                            External Macro for WWW
  761.  
  762.   This  macro, W from the  external macro config menu,  will be run after a
  763. successfull WWW connection to a site has been made.
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop            Page 12
  772.  
  773.                 Appendix A: Using Variables in Support Files
  774.  
  775. Inet_mac  allows the use of variables in included messages, signatures, and
  776. taglines.   These  variables are also  available in  external macros.   All
  777. built-in Commo variables can also be used.  The following  variables can be
  778. used in external macros only:
  779.  
  780. addr     The address of the site
  781. name     The name of the site
  782. type     The type of site (FTP, Telnet, etc.)
  783.  
  784. These variables can be used in the send mail function:
  785.  
  786. addr     The address of the person
  787. name     The name of the person
  788.  
  789. These variables are set by the config routine and can be used anywhere.  It
  790. is suggested that you don't change these because the changes won't be saved
  791. unless you instruct Inet_mac to do so:
  792.  
  793. prompt    Your systems prompt
  794. email     Your email address
  795. ftp_cmd   FTP command-line (usually NCFTP)
  796.  
  797. sigfile   Signature file for messages
  798. sitefile  The site database file
  799. msgfile   Default included message file
  800. aliasfil  Default email alias file
  801. distfile  Default distribution list
  802. logfile   Name of log file
  803. tagfile   Tagline file
  804. inetdir   Inet_mac directory for support files
  805.  
  806. ftp_mac   External macro for FTP
  807. goph_mac  External macro for Gopher
  808. rlog_mac  External macro for Rlogin
  809. teln_mac  External macro for Telnet
  810. www_mac   External macro for WWW
  811.  
  812. efnet1    Primary IRC Efnet server
  813. efnet2    Secondary IRC Efnet server
  814. undrnet1  Primary IRC Undernet server
  815. undrnet2 Secondary IRC Undernet server
  816. othernet  Other IRC server
  817. ircnick   IRC alias
  818. ircchan   Channel to join upon starting IRC
  819.  
  820. sound     Sound toggle
  821. rlog8bit  8-bit Rlogin toggle
  822. tagprmpt  Confirm tagline prompt
  823.  
  824. These are some miscelaneous variables that can be used anywhere:
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop            Page 13
  833.  
  834. iver      Version of Inet_mac you are using
  835.  
  836.                          Appendix B: Menu Shortcuts
  837.  
  838.  
  839.   As stated earlier, the main parts  of the program have shortcut keys that
  840. allow  you to go to  certain menus from the  terminal screen when the macro
  841. file is loaded.  Here is a list of these keys.
  842.  
  843. CTRL-F1   Site Menu
  844. CTRL-F2   Unix File Commands Menu
  845. CTRL-F3   Mail Functions
  846. CTRL-F4   IRC Menu
  847. CTRL-F5   Configuration Menu
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855. Internet in a Macro 1.0 by J.j. Meddaugh and Jeff Bishop            Page 14
  856.  
  857.                      OBTAINING NEW VERSIONS OF INET_mac
  858.  
  859.   All new  versions of the program, are  uploaded to the Commo  FTP site at
  860. ordata.com  in  the /pub/msdos/comm/COMMO  directory.    The filename  will
  861. always  start with the characters INET.   New versions are also uploaded to
  862. Charlie's Foxhole in Lansing, MI at 517-323-3405, the Global Blind Exchange
  863. (telnet   gbx.org),  and  to   CRIS,  a  division   of  Concentric  Network
  864. Corporation, a nationwide Internet service provider.  Finally, new versions
  865. are available on Macronet via  file request from Macronet node M1.   If you
  866. have  no other way to receive updates, please write me and ask to be placed
  867. on  my email  update list.    You will  receive new  updates when  they are
  868. released.
  869.  
  870.                                    Thanks
  871.  
  872.   I  would  like   to  thank   Fred  Brucker  for   designing  this   great
  873. telecommunications program.  I'd also like to thank Jeff Bishop who offered
  874. much  help in the design  of Internet in  a Macro.  I'd  also like to thank
  875. those people who  have sent me  comments and  suggestions about the  macro.
  876. They are always appreciated.
  877.  
  878.                                   Support
  879.  
  880.   If you  have a comment, suggestion or bug report  for Inet_mac, do one of
  881. the following:
  882.  
  883.  
  884. *  Subscribe  to   the  Commo  Mailing  List   by  sending  a   message  to
  885. listserv@server.nlbbs.com with the message "add commo" in the body.
  886. * Email me at jmeddaug@cris.com.
  887.